KAI Key Reader Implementation

The KAI Key Reader is a quick and easy method of checking in and out vehicles, saving you and your customer's time during the fleet management and agreement process. The KAI web service provides ATMS GEN2.0 with the latest physical Key Read from the KeyPool for a specified VIN, all from your computer or mobile device.

Setting up your location for the KAI Key Reader

Before the KAI Key Reader can be fully integrated, all locations at which the KAI Key Reader is to be used with the application must be configured to interpret the information provided by the KAI Key Reader.

Verify that your KeyReader is connected to the KeyPool. The Key Reader at your loaner desk should already be connected to the KeyPool. To verify this, perform a KeyRead with any key using the Key Reader at your desk. Then, open ISPA Next on any PC in your dealership. The KeyRead should show up in the KeyPool. If not, please contact your ISPI Admin.
Switch from the legacy GKI Key Reader to KAI WebService ATMS GEN2.0 as follows:

In the ATMS GEN2.0 Management Hub (Admin > Management tab), in the Admin panel on the left, click the location check box for which you want to configure the new Key Reader.
Find and edit () the management setting: BMW Key Reader Configuration.
Select the KAI WebService option from the BMW Key Reader list. The DISTRIBUTION PRODUCT NUMBER and OUTLET NUMBER will have been filled in for you.
(For locations with Connected Car integration) If you want ATMS GEN2.0 to use the new Key Reader as the default provider of fuel and mileage data on agreements (as opposed to a Connected Car telematics device), make sure the Prioritize Key Reader Data indicator () is turned on. ATMS GEN2.0 will only use data from the unit's Connected Car device if the Key Reader fails to retrieve fuel and mileage data on agreements.
If you want to lock the setting at a higher level (such as the dealer level), so it cannot be edited by a lower level (such as a dealer's locations), select the Locked toggle.
Click SAVE.
Find and edit () the management setting: Allow Add Vehicle Manually. Make sure it is turned on (), as it is required to add new units with the KAI Key Reader. Click SAVE.

Verify that you can open an agreement by reading a key for one of your units, then opening an agreement for the unit. You should see the following dialogue, which confirms that KAI WebService is configured correctly.

New Key Reader Instructions

The following instructions pertain specifically to the KAI Key Reader Integration. For complete instructions, see "Key Reader Integration" .

Note: Key Reads are stored in the KeyPool for seven (7) days. ATMS GEN2.0 will only consider Key Reads within the last hour as valid. If a key read older than an hour, it will not be displayed and you have to read the key again.

Adding a Unit

The ability to add a unit by Key Reader is only available for locations that can add units manually (Allow Add Vehicle Manually management setting is turned on).

On the New Unit page, enter a unique Unit Number, then type a VIN and press Tab.

The Key Reader is read for the unit. If key data is read successfully, a message is displayed with the VIN and current date and time as the Read Date. Click OK.

If key data was not retrieved or is invalid, a message is displayed with the option to TRY AGAIN or CANCEL, to return to the New Unit screen and enter a new VIN.

Enter any remaining required information (*). Click CONTINUE, and do the same for local information.

Note: The unit's Status is set to Ready and cannot be edited until the new unit is successfully added to the fleet.

Enter required information about the unit's location and dates (*). Click CONTINUE.
Click Save.

Editing a unit record

Find and edit a unit record by clicking Edit Unit on the side panel of the record.
The latest mileage and fuel (if available) is provided by the KAI Key Reader service. If key data was not retrieved or is invalid, a message is displayed with the option to RETRY or manually enter the fuel and mileage (MANUAL ENTRY). If you choose to manually enter the data, a REREAD KEY button becomes available under the fields.

Removing a Unit from the Fleet

Find and view the unit record, and click Remove From Fleet on the side panel of the record.
The latest mileage and fuel (if available) is provided by the KAI Key Reader service. If key data was not retrieved or is invalid, a message is displayed with the option to RETRY or manually enter the fuel and mileage (MANUAL ENTRY). If you choose to manually enter the data, a REREAD KEY button becomes available under the fields.

Opening an Agreement

Note: If your location also uses TSD Telematics (Connected Car integration), data from the KAI Key Reader is used on the agreement instead of the Connected Car telematics device, as long as the Prioritize Key Reader Data option is selected in your BMW Key Reader Management setting in Admin Setup.

When opening an agreement, click Select Unit.
Type the full Unit Number, or enter part of the Unit Number and/or select a Model to filter and select a unit from the list.

The latest mileage and fuel (if available) is provided by the KAI Key Reader. If key data was not retrieved or is invalid, a message is displayed with the option to RETRY or manually enter the fuel and mileage (MANUAL ENTRY). If you choose to manually enter the data, a REREAD KEY button becomes available under the fields.

Exchanging a Unit on the Agreement

Find and view agreement, and click Exchange Unit on the side panel.
For the original (returning) unit, the latest mileage and fuel (if available) is provided by the KAI Key Reader service, if the Prioritize Key Reader Data option is selected in your BMW Key Reader Management setting in Admin Setup.
Verify the Exchange Date and select a Return Date, and click CONTINUE.
Assign a replacement unit as follows:

Click SELECT UNIT.
Type the full Unit Number, or enter part of the Unit Number and/or select a Model to filter and select a unit from the list.
The latest mileage and fuel (if available) is provided by the KAI Key Reader. If key data was not retrieved or is invalid, a message is displayed with the option to RETRY or manually enter the fuel and mileage (MANUAL ENTRY). If you choose to manually enter the data, a REREAD KEY button becomes available under the fields. .

Closing an Agreement

Note: If your location also uses TSD Telematics, data from the KAI Key Reader is used on the agreement instead of the Connected Car telematics device, as long as the Prioritize Key Reader Data option is selected in your BMW Key Reader Management setting in Admin Setup.

Find the agreement and click Close. If already viewing the agreement, click Close Agreement.
Add and update the required information, marked by red asterisks (*). The latest mileage and fuel (if available) is provided by the KAI Key Reader. If key data was not retrieved or is invalid, a message is displayed with the option to RETRY or manually enter the fuel and mileage (MANUAL ENTRY). If you choose to manually enter the data, a REREAD KEY button becomes available under the fields.

Troubleshooting

If you receive the error message: "Key data was not retrieved or is invalid", do the following:

Verify that you are using the correct VIN.
Make sure that your KeyRead is not outdated. Remember that ATMS GEN2.0 only accepts KeyReads which are less than 1 hour old.
Verify that you can see the KeyRead in ISPA Next. If the KeyRead does not show up in ISPA Next, please contact your ISPI Admin.
If the KeyRead shows in ISPA Next, but not in ATMS GEN2.0, please contact your TSD support team at support@tsdweb.com.